Philosophie Markdown-D'abord et Principes Fondamentaux d'Architecture

La Fondation OpenClaw

1. La Philosophie Markdown-D'abord

OpenClaw considère la documentation lisible par l'humain comme la source absolue de vérité. Contrairement aux systèmes qui enfouissent la logique dans des bases de données, l'"âme" de l'agent est définie dans des fichiers texte, garantissant une transparence et un contrôle de version facilement accessible. contrôle de version.

SOUL.md : Définit le personnage et les limites éthiques.
AGENTS.md : Présente le flux de travail ingénierie.
MEMORY.md : Stocke les faits à long terme et les préférences.

2. Indépendant du Modèle et Autonome

Le runtime centralisé pour agents permet de changer de LLM (Claude, GPT, Local) sans réécrire la logique. Les agents autonomes fonctionnent 24h/24 grâce au planificateur HEARTBEAT.md .

3. Fiabilité et Intégrité des Données

Pour éviter la corruption d'état dans les environnements à haute concurrence, OpenClaw utilise l'isolement de session via des files de voies. La récupération des données est gérée par une RAG Local-D'abord architecture utilisant des instantanés sémantiques.

Configuration : openclaw.json

{ "global": { "port": 18789, "identity": "./config/SOUL.md", "env_injection": true }, "security": { "firewall": "strict", "rce_protection": true } }

Type a command...

Question 1

Why does OpenClaw prioritize a "Markdown-First" approach?

To increase the execution speed of the LLM.

To ensure transparency and human-readability.

To replace the need for JSON files entirely.

Question 2

What prevents "State Corruption" during simultaneous user interactions?

Local-First RAG

Semantic Snapshots

Session Isolation via Lane Queues

Challenge: The Debugger

Diagnose the missing agent behavior.

Problem: An agent has been deployed, but it is responding with a generic personality instead of its assigned role, and it cannot recall data from yesterday's session.

Analysis

Which files or components are likely misconfigured?

Diagnosis:
1. Persona Issue: Check SOUL.md and ensure it is correctly referenced in openclaw.json.
2. Memory Issue: Ensure MEMORY.md is writable and the Local-First RAG system is successfully creating Semantic Snapshots.